home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / choice25.zip / CHOICE.DOC < prev    next >
Text File  |  1992-11-08  |  12KB  |  275 lines
  1.  
  2.                              PLAYERS CHOICE 2.5
  3.                              ==================
  4.  
  5.          One of The Livewire BBS PCBoard(TM) multi-BBS Doorware programs.
  6.                   Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS,
  7.                      Remote Access, SpitFire, WWIV and others
  8.  
  9.                                       By
  10.  
  11.                                 Richard Paquette
  12.                                    PO Box 416
  13.                               Mt. Laurel, NJ 08054
  14.  
  15.                                (C) Copyright 1990
  16.                                All Rights Reserved
  17.  
  18.  
  19.                      DOOR DESCRIPTION!
  20.                                 ================
  21.  
  22.      This door is actually three doors in one.. first is the Game of Reverse
  23. which will allow you to pick how many numbers to reverse and then let you go
  24. and try to get them in order with the fewest moves possible.
  25.  
  26.      Game two is Findme which has an imaginary 10x10 grid with four spots that
  27. are occupied by "something", your mission is to find the exact positions of
  28. each of them by using numbers such as: y=9 and x=3 and if "something" was on
  29. that position, the door would reveal that to you. Limited amount of moves and
  30. then you can "see" where all the "somethings" where!
  31.  
  32.      Game three is Trapme which allows you six guesses to trap the number that
  33. we randomly picked, if you don't the game will let you know the number at the
  34. end of your guesses..
  35.  
  36.      We will eventually be developing this door into a huge arcade type door
  37. with probably 10 games built into one.. "any registrations now will include all
  38. future updates at no additional cost!!!!"
  39.     
  40.                                       FILES
  41.                                       =====
  42.              The following files are packaged with this ZIP
  43.  
  44.  choice.exe    <--- executable program must be in directory at all times
  45.  choice.cfg    <--- sample configuration file, must have one for each node
  46.  choice        <--- sample batch file
  47.  choice.doc    <--- what you are now reading
  48.  history.doc   <--- what's new in each upgrade
  49.  order.frm     <--- Order form for all Livewire Doors
  50.  
  51. CONFIGURATION
  52. -------------
  53.         My suggestion to any PCBoard Sysop running Ver 14.5+ is to call
  54.         USERS.SYS in your CFG file..
  55.  
  56.         EXAMPLE CONFIGURATION FILE FOR PCBOARD.SYS
  57.         ------------------------------------------
  58.  
  59.         C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  60.         The Livewire BBS    <=-  (Change this to your BBS name)
  61.         Richard             <=-  (The Sysop's first name)
  62.         Paquette            <=-  (The Sysop's last name)
  63.  
  64.         EXAMPLE CONFIGURATION FILE FOR USERS.SYS
  65.         ------------------------------------------
  66.  
  67.         C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  68.         The Livewire BBS    <=-  (Change this to your BBS name)
  69.         Richard             <=-  (The Sysop's first name)
  70.         Paquette            <=-  (The Sysop's last name)
  71.  
  72.         EXAMPLE CONFIGURATION FILE FOR DOOR.SYS
  73.         ---------------------------------------
  74.  NOTE:  If you are using the GAP "door.sys" then please be sure it is
  75.         the 52 line version or this door MAY NOT work!
  76.  
  77.         C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  78.         The Livewire BBS    <=-  (Change this to your BBS name)
  79.         Richard             <=-  (The Sysop's first name)
  80.         Paquette            <=-  (The Sysop's last name)
  81.  
  82.         EXAMPLE CONFIGURATION FILE FOR CALLINFO.BBS
  83.         -------------------------------------------
  84.  
  85.         C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  86.         The Livewire BBS    <=-  (Change this to your BBS name)
  87.         Richard             <=-  (The Sysop's first name)
  88.         Paquette            <=-  (The Sysop's last name)
  89.  
  90.         EXAMPLE CONFIGURATION FILE FOR DORINFOx.DEF
  91.         -------------------------------------------
  92.  
  93.         C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  94.                                   where 'x' is the BBS Node number.
  95.         The Livewire BBS    <=-  (Change this to your BBS name)
  96.         Richard             <=-  (The Sysop's first name)
  97.         Paquette            <=-  (The Sysop's last name)
  98.  
  99.         EXAMPLE CONFIGURATION FILE FOR SFDOORS.DAT
  100.         ------------------------------------------
  101.  
  102.         C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  103.         The Livewire BBS    <=-  (Change this to your BBS name)
  104.         Richard             <=-  (The Sysop's first name)
  105.         Paquette            <=-  (The Sysop's last name)
  106.  
  107.         EXAMPLE CONFIGURATION FILE FOR CHAIN.TXT
  108.         ----------------------------------------
  109.  
  110.         C:\BBS\CHAIN.TXT    <=-  (Full pathname of your CHAIN.TXT file)
  111.         The Livewire BBS    <=-  (Change this to your BBS name)
  112.         Richard             <=-  (The Sysop's first name)
  113.         Paquette            <=-  (The Sysop's last name)
  114.  
  115.                                  ==============
  116.  
  117.                                CHOICE BATCH FILE
  118.  
  119. This is the batch file whose name is entered in PCBSETUP. It should reside in
  120. your default PCB directory. Leave this as is except for changing the paths.
  121.  
  122.           ECHO OFF
  123.           E:
  124.           CD\CHOICE
  125.           CHOICE CHOICE.CFG  <--- Please read NOTE below
  126.           C:
  127.           CD\PCB
  128.           BOARD
  129.  
  130. IMPORTANT NOTE FOR DIGIBOARD USERS:
  131.  
  132.   Choice now includes support for FOSSIL drivers!!! This means your Doors
  133.  will work with Digiboard (e.g. Wildcat!'s M version) and other multi-port
  134.  boards. To activate the Fossil driver support, just include /FD on the
  135.  command line when running the Door. For example:
  136.  
  137.       CHOICE CHOICE.CFG /FD
  138.  
  139.  If no Fossil driver is available, Choice will display a message to that
  140.  effect and exit gracefully.
  141.  
  142. IMPORTANT NOTE FOR NON STANDARD IRQ's:
  143.  
  144.                   Supports COM 1 to 4 on the standard IRQ's
  145.                     Com1/Com3 = IRQ4 and Com2/Com4 = IRQ3
  146.  
  147.                You can make use of the IRQ environment variable
  148.  
  149.     If you wish to use a non-standard IRQ, add the IRQ number after the 
  150. configuration filename. For example the program is STORE and you want to use 
  151. Com1 and IRQ5. The command line passed to your door would be:
  152.  
  153.                             STORE STORE.CFG /5 
  154.                                    or
  155.              STORE STORE.CFG /%IRQ% using the environment variable
  156.  
  157.     The /5 tells STORE to use IRQ5 rather than the standard IRQ4 that is
  158. normally used with COM1. No /x parameter is needed for the standard IRQ's.
  159.  
  160.    You can also make use of the PCBoard environment variables such as:
  161.  PCBDRIVE and PCBDIR. Or you can use your own for example, let's say that
  162.  your system runs on D: drive and your system directory is call GAP then
  163.  you could use the variables at the start of your batch file such as:
  164.  
  165.    d:\
  166.    cd\doors\facts
  167.    set pcbdrive=d:
  168.    set pcbdir=\gap
  169.    facts facts.cfg
  170.    d:\
  171.    cd\gap
  172.    gap
  173.  
  174.  Then the first line in your cfg would look like this:
  175.  
  176.                      %PCBDRIVE%%PCBDIR\dorinfo.def
  177.  
  178.                                 BULLETINS
  179.                                 ---------
  180.        There is currently NO bulletin created when using Players Choice, but
  181.        we will be adding one in one of the next versions.. Be looking for any
  182.        upgrades on Salt Air BBS or The Livewire BBS!
  183.                
  184.                     ------------------------------------
  185.  
  186.                                 DOOR OPERATION
  187.                                 --------------
  188.   
  189.   F3    -   Toggles the printer On/Off.
  190.             Value is passed to PCBoard.
  191.   F4    -   Toggles the Page Bell On/Off.
  192.             Value is passed to PCBoard.
  193.   F5    -   DOS Shell.  Allows SysOp to exit to DOS from inside a DOOR.
  194.   F7    -   Toggles the Caller Alarm On/Off.
  195.             Value is passed to PCBoard.
  196.   F8    -   Returns the caller involuntarily to PCBoard.
  197.             Without letting them know that the sysop called them back!
  198.   F9    -   Toggles the local display On/Off.
  199.             Value is passed to PCBoard.
  200.   F10   -   Activates SysOp CHAT mode within the DOOR.
  201.  
  202.   ESC   -   Deactivates CHAT mode.  DOOR is resumed.
  203.   HOME  -   HELP key for status line options.
  204.   UP    -   Allows the SysOp to temporarily give the caller extra time
  205.             while in the DOOR.  This time is NOT passed to PCBoard.
  206.   DN    -   Allows the SysOp to temporarily subtract time from the
  207.             caller while in the DOOR.  This time is NOT passed to PCBoard.
  208.   ALT-N -   SysOp next on toggle.
  209.             Value is passed to PCBoard.
  210.   ALT-X -   PCBoard will exit after current caller logs off.
  211.             Value is passed to PCBoard.
  212.  
  213.                             WATCHDOG/CTTY/ANSI.SYS
  214.                             ----------------------
  215.  
  216.         CTTY and WATCHDOG are not required and should not be used with
  217.         this program.  CHOICE contains its own communication routines
  218.         which monitor the COM port.  If carrier is lost, it will return
  219.         to PCBoard where the BBS will log the user off the system.
  220.         ANSI.SYS, or something similar, is required for CHOICE to
  221.         function properly!
  222.  
  223.                                  DISTRIBUTION
  224.                                  ------------
  225.  
  226.         CHOICE is COPYRIGHTED by Richard Paquette, with all rights reserved.
  227.         This program is being distributed via the SHAREWARE concept and as
  228.         such, may be copied freely with the following restrictions:
  229.  
  230.                 * The program must be supplied in it's original
  231.                   unmodified form, including documentation.
  232.  
  233.                 * CHOICE may not be distributed as part of any
  234.                   commercial application or service without the
  235.                   express, written consent of the author.
  236.  
  237.                 * Vendors of Shareware/Public Domain software may
  238.                   not distribute this program without the express,
  239.                   written consent of the author.
  240.  
  241.                                  REGISTRATION
  242.                                  ------------
  243.  
  244.         CHOICE represents many hours of programming and the author
  245.         deserves just compensation for his time, efforts and expertise.
  246.         If you find this program to be of some value and you continue
  247.         to use it on your BBS system, you must return the registration
  248.         form provided along with the registration fee. Registration
  249.         entitles you to one year free access on The Livewire BBS.
  250.         
  251.         Thereafter access is only $15.00 per year. Payment should be
  252.         made in the form of a check or money order (do NOT send cash!).
  253.         Foreign orders must be in U.S. funds drawn on a U.S. bank.
  254.  
  255.            **********           REGISTER ONLINE          ***********
  256.  
  257.         You may also call The Livewire BBS and register online via
  258.         Visa or Mastercard using our online Credit Card door which will 
  259.         produce your registration number on the spot! At the main board
  260.         prompt just type  OPEN;1  and presto.. 
  261.  
  262.         Suggestions and/or comments may be sent to the address below or
  263.         via electronic mail: 
  264.  
  265.                   HUBSNJ for RelayNet and Node ID is: LIVEWIRE
  266.  
  267.                                 Richard Paquette
  268.                                 The Livewire BBS     
  269.  
  270.                    (609) 235-5297 MNP/5 - 300/1200/2400
  271.                    (609) 866-2551 HST/V.32 - 12/24/96/19,2/38,4
  272.                    (609) 727-3246 V.42/MNP/5 - 300/1200/2400
  273.  
  274.                             ----------------------
  275.